home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
IRIX Base Documentation 1998 November
/
IRIX 6.5.2 Base Documentation November 1998.img
/
usr
/
share
/
catman
/
p_man
/
cat3
/
Xm
/
XmClipboardInquireCount.z
/
XmClipboardInquireCount
Wrap
Text File
|
1998-10-30
|
5KB
|
133 lines
XXXXmmmmCCCClllliiiippppbbbbooooaaaarrrrddddIIIInnnnqqqquuuuiiiirrrreeeeCCCCoooouuuunnnntttt((((3333XXXX))))UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVVXXXXmmmmCCCClllliiiippppbbbbooooaaaarrrrddddIIIInnnnqqqquuuuiiiirrrreeeeCCCCoooouuuunnnntttt((((3333XXXX))))
NNNNAAAAMMMMEEEE
XXXXmmmmCCCClllliiiippppbbbbooooaaaarrrrddddIIIInnnnqqqquuuuiiiirrrreeeeCCCCoooouuuunnnntttt - A clipboard function that returns
the number of data item formats
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
#include <Xm/CutPaste.h>
int XmClipboardInquireCount (_d_i_s_p_l_a_y, _w_i_n_d_o_w, _c_o_u_n_t,
_m_a_x__f_o_r_m_a_t__n_a_m_e__l_e_n_g_t_h)
Display * _d_i_s_p_l_a_y;
Window _w_i_n_d_o_w;
int * _c_o_u_n_t;
unsigned long * _m_a_x__f_o_r_m_a_t__n_a_m_e__l_e_n_g_t_h;
(vvvvooooiiiidddd)
VVVVEEEERRRRSSSSIIIIOOOONNNN
This page documents Motif 2.1.
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
XXXXmmmmCCCClllliiiippppbbbbooooaaaarrrrddddIIIInnnnqqqquuuuiiiirrrreeeeCCCCoooouuuunnnntttt returns the number of data item
formats available for the data item in the clipboard. This
function also returns the maximum name-length for all
formats in which the data item is stored.
_d_i_s_p_l_a_y Specifies a pointer to the DDDDiiiissssppppllllaaaayyyy structure that
was returned in a previous call to XXXXOOOOppppeeeennnnDDDDiiiissssppppllllaaaayyyy or
XXXXttttDDDDiiiissssppppllllaaaayyyy.
_w_i_n_d_o_w Specifies the window ID of a widget that relates
the application window to the clipboard. The
widget's window ID can be obtained through
XXXXttttWWWWiiiinnnnddddoooowwww. The same application instance should
pass the same window ID to each of the clipboard
functions that it calls.
_c_o_u_n_t Returns the number of data item formats available
for the data item in the clipboard. If no formats
are available, this argument equals 0 (zero). The
count includes the formats that were passed by
name.
_m_a_x__f_o_r_m_a_t__n_a_m_e__l_e_n_g_t_h
Specifies the maximum length of all format names
for the data item in the clipboard.
RRRREEEETTTTUUUURRRRNNNN
_X_m_C_l_i_p_b_o_a_r_d_S_u_c_c_e_s_s
The function was successful.
_X_m_C_l_i_p_b_o_a_r_d_L_o_c_k_e_d
The function failed because the clipboard was
locked by another application. The application can
continue to call the function again with the same
Page 1 (printed 10/24/98)
XXXXmmmmCCCClllliiiippppbbbbooooaaaarrrrddddIIIInnnnqqqquuuuiiiirrrreeeeCCCCoooouuuunnnntttt((((3333XXXX))))UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVVXXXXmmmmCCCClllliiiippppbbbbooooaaaarrrrddddIIIInnnnqqqquuuuiiiirrrreeeeCCCCoooouuuunnnntttt((((3333XXXX))))
parameters until the lock goes away. This gives
the application the opportunity to ask if the user
wants to keep trying or to give up on the
operation.
_X_m_C_l_i_p_b_o_a_r_d_N_o_D_a_t_a
The function could not find data on the clipboard
corresponding to the format requested. This could
occur because the clipboard is empty; there is
data on the clipboard, but not in the requested
format; or the data in the requested format was
passed by name and is no longer available.
RRRREEEELLLLAAAATTTTEEEEDDDD
XXXXmmmmCCCClllliiiippppbbbbooooaaaarrrrddddSSSSttttaaaarrrrttttCCCCooooppppyyyy(3).
Page 2 (printed 10/24/98)